Skip to main content

M-Pesa Statement Analysis​

POST https://api.sat.tausi.africa/v2/vodacom/3d_analysis

This analyses the pdf and generates the report. The response is in a json format.

Header Requirements​

  • Authorization --required

Body Params​

  • file --required
  • fullname --required
curl example request
curl -X 'POST' 'https://api.sat.tausi.africa/v2/vodacom/3d_analysis'
 -F fullname=Hussein \ 
 -F 'file=@M_Pesa_789981_Statement.pdf' \
 -H 'Authorization: Bearer XXXXXXXXXXX' \'

Response Sample​

  1. Status OK Response
200 OK
{
    "analysis_period": {
      "start_date": "December 2023",
      "end_date": "May 2024"
    },
    "cash_flow_analysis": {
      "cash_inflow": [
        {"month": "May 2024", "amount": "TZS 2,200,000", "percentage": "15.79%"},
        {"month": "April 2024", "amount": "TZS 3,000,000", "percentage": "21.43%"},
        {"month": "March 2024", "amount": "TZS 2,500,000", "percentage": "17.86%"},
        {"month": "February 2024", "amount": "TZS 1,800,000", "percentage": "12.86%"},
        {"month": "January 2024", "amount": "TZS 1,500,000", "percentage": "10.71%"},
        {"month": "December 2023", "amount": "TZS 2,000,000", "percentage": "14.29%"}
      ],
      "cash_outflow": [
        {"month": "May 2024", "amount": "TZS 2,200,000", "percentage": "15.79%"},
        {"month": "April 2024", "amount": "TZS 1,500,000", "percentage": "10.71%"},
        {"month": "March 2024", "amount": "TZS 1,800,000", "percentage": "12.86%"},
        {"month": "February 2024", "amount": "TZS 2,500,000", "percentage": "17.86%"},
        {"month": "January 2024", "amount": "TZS 3,000,000", "percentage": "21.43%"},
        {"month": "December 2023", "amount": "TZS 3,000,000", "percentage": "21.43%"}
      ]
    },
    "agent_activity_analysis": {
      "deposits": [
        {"month": "May 2024", "amount": "TZS 2,200,000", "percentage": "15.79%"},
        {"month": "April 2024", "amount": "TZS 3,000,000", "percentage": "21.43%"},
        {"month": "March 2024", "amount": "TZS 2,500,000", "percentage": "17.86%"},
        {"month": "February 2024", "amount": "TZS 1,800,000", "percentage": "12.86%"},
        {"month": "January 2024", "amount": "TZS 1,500,000", "percentage": "10.71%"},
        {"month": "December 2023", "amount": "TZS 2,000,000", "percentage": "14.29%"}
      ],
      "withdrawals": [
        {"month": "May 2024", "amount": "TZS 2,200,000", "percentage": "15.79%"},
        {"month": "April 2024", "amount": "TZS 1,500,000", "percentage": "10.71%"},
        {"month": "March 2024", "amount": "TZS 1,800,000", "percentage": "12.86%"},
        {"month": "February 2024", "amount": "TZS 2,500,000", "percentage": "17.86%"},
        {"month": "January 2024", "amount": "TZS 3,000,000", "percentage": "21.43%"},
        {"month": "December 2023", "amount": "TZS 3,000,000", "percentage": "21.43%"}
      ]
    },
    "peer_to_peer_activity": {
      "money_sent": [
        {"month": "May 2024", "amount": "TZS 1,800,000", "percentage": "20%"},
        {"month": "April 2024", "amount": "TZS 2,500,000", "percentage": "28%"},
        {"month": "March 2024", "amount": "TZS 1,500,000", "percentage": "17%"},
        {"month": "February 2024", "amount": "TZS 1,200,000", "percentage": "13%"},
        {"month": "January 2024", "amount": "TZS 1,300,000", "percentage": "15%"},
        {"month": "December 2023", "amount": "TZS 700,000", "percentage": "7%"}
      ],
      "money_received": [
        {"month": "May 2024", "amount": "TZS 2,000,000", "percentage": "22%"},
        {"month": "April 2024", "amount": "TZS 2,200,000", "percentage": "24%"},
        {"month": "March 2024", "amount": "TZS 1,400,000", "percentage": "16%"},
        {"month": "February 2024", "amount": "TZS 1,100,000", "percentage": "12%"},
        {"month": "January 2024", "amount": "TZS 1,800,000", "percentage": "20%"},
        {"month": "December 2023", "amount": "TZS 500,000", "percentage": "6%"}
      ]
    },
    "bank_to_wallet_activity": {
      "bank_to_wallet": [
        {"month": "May 2024", "amount": "TZS 1,000,000", "percentage": "25%"},
        {"month": "April 2024", "amount": "TZS 800,000", "percentage": "20%"},
        {"month": "March 2024", "amount": "TZS 600,000", "percentage": "15%"},
        {"month": "February 2024", "amount": "TZS 1,200,000", "percentage": "30%"},
        {"month": "January 2024", "amount": "TZS 400,000", "percentage": "10%"}
      ]
    },
    "bills_payments": {
      "payments": [
        {"month": "May 2024", "amount": "TZS 1,700,000", "percentage": "34%"},
        {"month": "April 2024", "amount": "TZS 1,300,000", "percentage": "26%"},
        {"month": "March 2024", "amount": "TZS 900,000", "percentage": "18%"},
        {"month": "February 2024", "amount": "TZS 600,000", "percentage": "12%"},
        {"month": "January 2024", "amount": "TZS 500,000", "percentage": "10%"}
      ]
    }
  }